home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / pbm / pbm_man.zoo / man1 / pgmtopbm.1 < prev    next >
Text File  |  1994-08-27  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. pgmtopbm(1)              USER COMMANDS                pgmtopbm(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      pgmtopbm - convert a portable graymap into a portable bitmap
  10.  
  11. SYNOPSIS
  12.      pgmtopbm [-floyd|-fs|-threshold [-value _✓v_✓a_✓l] [_✓p_✓g_✓m_✓f_✓i_✓l_✓e]
  13.  
  14. DESCRIPTION
  15.      Reads a portable graymap as input.  Produces a portable bit-
  16.      map as output.
  17.  
  18.      Note that there is no pbmtopgm converter,  because  any  pgm
  19.      program can read pbm files automagically.
  20.  
  21. OPTIONS
  22.      The default quantization method  is  boustrophedonic  Floyd-
  23.      Steinberg error diffusion (-floyd).  Also available are sim-
  24.      ple thresholding (-threshold);  Bayer's  ordered  dither  (-
  25.      dither8)  with  a 16x16 matrix; and three different sizes of
  26.      45-degree  clustered-dot  dither  (-cluster3,  -cluster4,  -
  27.      cluster8).
  28.  
  29.      Floyd-Steinberg will almost always  give  the  best  looking
  30.      results;  however, looking good is not always what you want.
  31.      For instance, thresholding can be used in  a  pipeline  with
  32.      the  _✓p_✓n_✓m_✓c_✓o_✓n_✓v_✓o_✓l tool, for tasks like edge and peak detection.
  33.      And clustered-dot dithering gives a  newspaper-ish  look,  a
  34.      useful special effect.
  35.  
  36.      The -value flag alters the  thresholding  value  for  Floyd-
  37.      Steinberg  and  simple  thresholding.   It  should be a real
  38.      number between 0 and 1.   Above  0.5  means  darker  images;
  39.      below 0.5 means lighter.
  40.  
  41.      All flags can be abbreviated to their shortest  unique  pre-
  42.      fix.
  43.  
  44. REFERENCES
  45.      The only reference you need for this stuff is "Digital Half-
  46.      toning" by Robert Ulichney, MIT Press, ISBN 0-262-21009-6.
  47.  
  48. SEE ALSO
  49.      pbmreduce(1), pgm(5), pbm(5), pnmconvol(1)
  50.  
  51. AUTHOR
  52.      Copyright (C) 1989 by Jef Poskanzer.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Sun Release 4.0     Last change: 26 July 1988                   1
  64.  
  65.  
  66.  
  67.